home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 1 / your choice.zip / your choice / OS2 / TRASHCAN / READ.ME < prev    next >
Text File  |  1994-02-26  |  9KB  |  192 lines
  1. ----------------------------------------------------------------------------
  2.               Workplace Shell TrashCan     Version 1.3
  3.  
  4.                     (c) Kai Sommerfeld 1993,1994
  5. ----------------------------------------------------------------------------
  6.  
  7. IMPORTANT FOR UPGRADING FROM VERSION 1.0 OF WPS TRASHCAN:
  8.         - Due to a bug in old install.exe you must delete the trashcan
  9.           folder manually from the commandline. (e.g. rd \desktop\trashcan)
  10.           BEFORE you install the new version using the new install.exe.
  11.           (I DO very sorry that, folks!!!)
  12.         - If you not doing so, it doesn't matter, but the old trashcan
  13.           folder will not be deleted during installation, although you do
  14.           not see it on your desktop!! (Oh, Ohhh)
  15.  
  16. ---------------------------------------------------------------------------
  17. SHORT DESCRIPTION:
  18.  
  19. Workplace Shell TrashCan is a WPS class designed to replace the shredder
  20. object delivered with OS/2 2.1.
  21. It gives you a 'macintosh - like' trashcan on your desktop. There are some
  22. usefull options to handle the trash you 'produce' in your dayly sessions.
  23.  
  24.  
  25. SYSTEM REQUIREMENTS:
  26.        OS/2 2.1 (or higher). The TrashCan will not run under OS/2 2.0,
  27.        because I used methods, API-calls, ..., which are new in OS/2 2.1.
  28.  
  29.  
  30. DISCLAIMER:
  31.        THE SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS"
  32.        WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK AS TO THE RESULTS AND
  33.        PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU.
  34.  
  35.  
  36. INSTALLATION:
  37.         - Just run 'install.exe' from the OS/2 Command prompt or
  38.           doubleclick the 'install.exe' icon.
  39.         - Make sure all suggested pathes are correct.
  40.         - Push the 'Install' button.
  41.         - All nessecary files will now be copied to your hard disk and
  42.           the class library will be registered to WPS.
  43.         - After that the TrashCan object will appear on your desktop.
  44.  
  45.  
  46. DEINSTALLATION:
  47.         ( I hope, you'll never do this ! )
  48.         - Run install.exe again. The program automatically detects whether
  49.           the TrashCan class library is already installed.
  50.         - After next reboot the TrashCan is gone away ....
  51.  
  52.  
  53. UPDATE TO ANOTHER VERSION OF TRASHCAN:
  54.         - Use install.exe to deinstall the current version of the TrashCan.
  55.           (See: DEINSTALLATION.)
  56.         - ATTENTION: Don't forget to REBOOT after the deinstallation!!!
  57.         - After that follow the steps described under INSTALLATION.
  58.  
  59.  
  60. WHAT DOES IT DO:
  61.         The TrashCan is folder to keep 'data trash' (any WPS-objects)
  62.         in a save place with the ability of getting it back for use, if
  63.         necessary.
  64.         Otherwise, the TrashCan is able to shred all (?) objects on your
  65.         desktop! Means, it also destroys trash, that is generally not
  66.         deleteable. Be carefully... If you empty the TrashCan, the objects
  67.         are really destroyed!!!
  68.  
  69.         Objects in the TrashCan only have to context menu items:
  70.                 - 'Move' : Use this to move the selected object(s) out
  71.                            of the TrashCan to any place you want.
  72.                 - 'Shred': Use this to destroy the selected object(s).
  73.          
  74.         Special features you may choose from TrashCan's settings notebook:
  75.  
  76.                 1. Auto empty of the TrashCan every time you start the
  77.                    system.
  78.                 2. You can set a limit for trashhold, if you want to.
  79.                    If this is reached, you must empty the TrashCan, shred
  80.                    one or more objects in the 'Can' or increase the
  81.                    capacity of the TrashCan before you can put more into
  82.                    it. But the default is unlimited trashhold.
  83.                    You may select an auto-delete mode, where the oldest
  84.                    objects in the TrashCan will be deleted automatically,
  85.                    if the limit of trashhold you set, is reached.
  86.                 3. You may change the TrashCan icons to your own favourite.
  87.                    ( Note: Drag and drop is available, but with a little
  88.                      limitation described in the online help. )
  89.  
  90.         And for the MMPM/2 freaks:
  91.                 If you define a sound for 'Shred' in the 'Sound' Notebook
  92.                 (located in 'System Setup' folder), and you select 'Use
  93.                 'shredder' sound' in the 'sound notebookpage' of the
  94.                 TrashCan, you will hear this everytime you drop any object
  95.                 on the TrashCan or you empty it.
  96.  
  97.  
  98. TROUBLESHOOTING:
  99.         If you empty the TrashCan (or shred object(s)) and get the message
  100.         "Cannot delete ....", just let the messagebox where it is. Simply
  101.         drag the 'nondeleteable object' out of the TrashCan. The Box will
  102.         go away ... and it's your turn to 'master' this crazy object.
  103.         ( Nobody is perfect! )
  104.  
  105.  
  106. HOW MUCH TO PAY FOR WPS TRASHCAN ?
  107.         You don't have to pay anything for the TrashCan. But if you want
  108.         to, send me a nice postcard from your home town.
  109.  
  110.  
  111. KNOWN BUGS:
  112.         1. Don't put a 'printer object' into the TrashCan. If you want to
  113.            destroy it, the system may hang!!! (But I don't know the reason
  114.            for that!!! Does anybody ... ???)
  115.         2. Due to a bug in WPS ( 2.1 GA ), you will get absurd result, if
  116.            you try to move object(s) from write protected media (CD-ROM, 
  117.            write protected Floppy, ...) to other drives/folders. It will
  118.            neither crash your WPS nor do other dangerous things with your
  119.            system, but you will have the following 'experience':
  120.                a)  You're allowed to drop the object(s) on TrashCan
  121.                    ( no stop sign ).
  122.                b)  The 'move' dialog appears on your desktop and the
  123.                    'move' operation starts. (means, the objects will be
  124.                    copied to the TrashCan folder, first)
  125.                c)  Then you get the message "The system cannot write to
  126.                    the write protected drive ...." (Thats quite right!!!)
  127.                    Thats why system's attempt to delete the object on the
  128.                    source drive, failes.
  129.                d)  If you select 'Return error code to program', the object
  130.                    in the source folder will no longer to be seen. (But its 
  131.                    still there, of course - try a 'refresh now'!)
  132.  
  133.            Summary: The objects to be moved to the TrashCan will be copied
  134.                     to it! Thats it!
  135.  
  136.            Why does this happen? ( Information for developers )
  137.                DRAGITEM structs are initialized incorrect for those objects.
  138.                There is the DO_MOVEABLE attribute set in fsSupportedOps,
  139.                and this is nonsens for objects on write protected media!!! 
  140.  
  141.  
  142. COMMENTS:
  143.         The WPTrashCan class is still under development. It seems to run
  144.         very stable but there may be any bugs anyway!
  145.  
  146.  
  147. REVISION HISTORY:
  148.  
  149. 07.01.94  Version 1.0
  150.         - initial release
  151.  
  152. 01.02.94  Version 1.1
  153.         - user defineable icons implemented 
  154.            (Sounds simple, but belive me, it was a hard job!)
  155.         - some fixes in 'undo' feature in the new notebook pages
  156.         - minor changes in install.exe
  157.  
  158. 18.02.94  Version 1.2
  159.         - created new default icons
  160.         - fixed a bug with drag and drop of large icon files
  161.         - added a frame around the icon displayed in 'Current icon' while
  162.           drag and drop operations, so this is similar to the original
  163.           WPS object's behaviour
  164.         - added 'auto delete on limit-reach' mode to the options notebook
  165.           page
  166.  
  167. 26.02.94  Version 1.3
  168.         - If 'auto delete on limit-reach' is active, and an object larger
  169.           then the specified trashcan capacity is put into the trashcan,
  170.           this object will be deleted immediately; instead of deleteting
  171.           first all old objects and then the new object too (result was
  172.           in v1.2 an empty trashcan!)
  173.         - added a validation check for trashcan capacity on installing,
  174.           moving (to another drive) of the trashcan
  175.         - fixed a bug with drag and drop from other apps to trashcan
  176.           (e.g. from FileManager/2). There was no drop on trashcan possible
  177.           (always stop sign when dragging over).
  178.         - added sound to some TrashCan actions.
  179.           [ Thanks to Robert Novitskey (Big Bad BoB) for the hint, how
  180.             to do this! ]
  181.  
  182. ----------------------------------------------------------------------------
  183. Send any comments / bug reports to:
  184.  
  185.         Kai Sommerfeld
  186.         Hochschulstr. 48  07/08
  187.         D-01069 Dresden
  188.         GERMANY
  189.  
  190.         or just email me:  ks1@irz.inf.tu-dresden.de
  191. ----------------------------------------------------------------------------
  192.